home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _graphics / graphics / _vduobject / docs / guide next >
Encoding:
Text File  |  1992-05-07  |  7.0 KB  |  157 lines
  1.  
  2. VDUobject 1.02
  3. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  4.  
  5. Purpose
  6. ¯¯¯¯¯¯¯
  7. The purpose of this appllication is to convert VDU-sequences into a 
  8. Drawfile.A VDU-sequence of a plotted image can be sent to a file in eg. a 
  9. BASIC program by 'spooling the image' whilst plotting takes place. This 
  10. means that complex calculations and accurate placement can be used in 
  11. drawfiles.
  12.  
  13. Guide
  14. ¯¯¯¯¯
  15. The use of this application is quite straightforward, just drag a 
  16. VDU­sequence (file type RawData (FF1)) on the iconbar and drag the 
  17. resulting Drawfile into a directory viewer.
  18.  
  19. All parameters have fixed values.
  20.  
  21. The file 'VDUinterp' gives a summary of implemented and ignored VDU-codes
  22.  
  23. Restrictions:
  24. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  25. Of course there are some VDU-codes which are not meaningful in a Drawfile
  26. (like flashing colours) or hard to implement (eg. block copy or move). I'll 
  27. now discuss these codes.
  28.  
  29. (codes not mentioned are implemented)
  30.  
  31. VDU 1        : Ignored (the printer is not meaningful here)
  32. VDU 2        : Ignored  (the same)
  33. VDU 3        : Ignored  (the same)
  34. VDU 4        : Normal but because in VDU 4 mode the screen might scroll all 
  35.                characters which follows follow as well as all cursor 
  36.                movements are ignored until the next VDU 5
  37. VDU 5        : Normal but only the standard direction of printing is 
  38.                supported. So positive X is to the right and positive Y is 
  39.                downwards (see VDU 23,
  40. VDU 6        : Ignored (not meaningful, see also VDU 21)
  41. VDU 7        : Ignored (impossible to implement)
  42. VDU 8        : Normal but ignored in VDU 4 mode (see VDU 4)
  43. VDU 9        : Normal but ignored in VDU 4 mode (see VDU 4)
  44. VDU 10       : Normal but ignored in VDU 4 mode (see VDU 4)
  45. VDU 11       : Normal but ignored in VDU 4 mode (see VDU 4)
  46. VDU 13       : Normal but ignored in VDU 4 mode (see VDU 4)
  47. VDU 14       : Ignored because won't be any scroll anyway
  48. VDU 15       : Ignored because won't be any scroll anyway
  49. VDU 18       : Action=action AND NOT %1111. So only the overwrite mode is 
  50.                possible. Because inverting or exclusive OR-ing etc. are very 
  51.                difficult to implement if not impossible. The colour patterns 
  52.                are implemented as the average of the colours used in the 
  53.                pattern (as this is the most common use of those patterns)
  54. VDU 19       : Only mode 0-15 and 16 are used. Other modes are ignored 
  55.                because they are meaningless (in Drawfiles).
  56. VDU 21       : Ignored see VDU 6
  57. VDU 23,0     : Ignored (not meaningful)
  58. VDU 23,1     : Ignored (not meaningful)
  59. VDU 23,6     : Only the first parameter is significant because the default 
  60.                length of the cycle is 8 bits and there is (as far as I know) 
  61.                no VDU-sequence to set a different length.
  62. VDU 23,7-8   : Ignored because a text window cannot be defined and scrolling 
  63.                is not allowed
  64. VDU 23,9-10  : Ignored (not meaningful)
  65. VDU 23,16    : Ignored because changing the direction of printing it's not 
  66.                implemented yet
  67. VDU 23,17,6  : Ignored because the average is taken from the colours of the 
  68.                pattern
  69. VDU 23,18-24 : Ignored (reserved for future expansion)
  70. VDU 23,25-26 : Ignored (Font Manager)
  71. VDU 23,27    : Ignored (Sprite Manager)
  72. VDU 23,28-31 : Ignored (reserved for applications)
  73. VDU 23,32-255: Ignored (impossible to implement in Drawfiles)
  74. VDU 24       : Normal for VDU 5 text expects that no characters are clipped 
  75.                nor that any of the objects have been created with VDU 25.
  76. VDU 25       : Type AND 7     :
  77.                Normal ,but in stead of the logical inverse colour is the 
  78.                foreground colour used.
  79.                Type AND NOT 7 :
  80.                8   : Solid line (including final point)
  81.                24  : Dotted line (including final point)
  82.                32  : Solid line (including initial point)
  83.                40  : Solid line (including both endpoints)
  84.                48  : Dotted line (including initial point)
  85.                56  : Dotted line (including both endpoints)
  86.                64  : Filled rectangle (point size)
  87.                72  : Ignored (impossible to implement)
  88.                88  : Ignored (impossible to implement)
  89.                104 : Ignored (impossible to implement)
  90.                120 : Ignored (impossible to implement)
  91.                128 : Ignored (impossible to implement)
  92.                136 : Ignored (impossible to implement)
  93.                184 : Ignored (impossible to implement)
  94.                208 : Ignored (Font Manager)
  95.                216 : Ignored (reserved)
  96.                224 : Ignored (reserved)
  97.                232 : Ignored (Sprite Manager)
  98.                240 : Ignored (reserved)
  99.                248 : Ignored (reserved)
  100. VDU 28       : Ignored because VDU 4 text is ignored too
  101. VDU 30       : Normal but ignored in VDU 4 mode
  102. VDU 31       : Normal but ignored in VDU 4 mode
  103. VDU 32-255   : Normal but ignored in VDU 4 mode
  104.  
  105. The definition of the logical colours (VDU 19) doesn't affect earlier 
  106. objects defined with that colour (So you can create 16 million colour 
  107. drawings in mode 0).
  108.  
  109. Finally some remarks about the linewidth and the type of join used as 
  110. default. The linewidth is a multiple of OS-units (Operating System 
  111. Unit=1/180inch). So in mode 12 all lines have a width of 4 OS-units (which 
  112. is in terms of pointsize, as used in Draw, about 4*0.4=1.6 points). This 
  113. means that horizontal lines have the proper width but vertical lines are 2 
  114. times the normal width of 2 OS-units. Only in square pixel modes (e.g. 1, 4, 
  115. 9, 13, 18 and 21) the linewidth is correct for both horizontal and vertical 
  116. lines.
  117. The joint between two lines has bevelled edges to smoothen the sharp point 
  118. when two lines intersect at a small angle.
  119.  
  120. The desktop frontend was written by John 'Translator' Kortink
  121.  
  122. If you have any comment about bugs or features please write to:
  123.  
  124. Pieter Gosselink
  125. Witbreuksweg 381 - 107
  126. 7522 ZA  ENSCHEDE
  127. The Netherlands
  128.  
  129.  
  130. New versions of this application can be obtained from the same address by 
  131. sending some money to cover postage and a self-adressed envelope containing 
  132. a 3.5" disc.
  133.  
  134. ____________________________________________________________________________
  135.  
  136.  
  137. This application is build upon the DrawFile-Generator also available from 
  138. the above author. The generator version used in VDUobject and which is also 
  139. supplied separately in the directory 'docs.generator' is actually a cut-down 
  140. version of the Generator which can be obtained by becoming a registered 
  141. user.
  142. For more information about the features of the Generator and about becoming 
  143. a registered user, you'd refer to the documentation of the 'generator' in 
  144. the equally named subdirectory of this application.
  145.  
  146. ____________________________________________________________________________
  147.  
  148. You may NOT change this application or use ANY part of it in other products
  149. without my approval. You may spread it freely (with *ALL* files included), 
  150. but not for any profit. This software is provided 'as is'. Using it is 
  151. entirely at your own risk.
  152. ____________________________________________________________________________
  153.  
  154.  
  155.  
  156.  
  157.